home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / makemovie.z / makemovie
Text File  |  1998-10-30  |  14KB  |  265 lines
  1.  
  2.  
  3.  
  4. mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))                                                      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      makemovie - make a movie from movie, image, and audio files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee [----oooo oooouuuuttttffffiiiilllleeee] [----ffff ffffoooorrrrmmmmaaaatttt] [----cccc ccccoooommmmpppprrrreeeessssssssiiiioooonnnn] [----llll llllooooooooppppmmmmooooddddeeee]
  13.      [----rrrr ffffrrrraaaammmmeeeerrrraaaatttteeee] [----iiii iiiinnnntttteeeerrrrllllaaaacccciiiinnnngggg] [----tttt] [----ssss xxxxssssiiiizzzzeeee,,,,yyyyssssiiiizzzzeeee] [----bbbb]
  14.      [----qqqq ssssppppaaaattttiiiiaaaallll____qqqquuuuaaaalllliiiittttyyyy] [----pppp tttteeeemmmmppppoooorrrraaaallll____qqqquuuuaaaalllliiiittttyyyy] [----aaaa bbbbiiiittttrrrraaaatttteeee]
  15.      [----kkkk kkkkeeeeyyyyffffrrrraaaammmmeeee____rrrraaaatttteeee] [ file1 ... ]
  16.  
  17.      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----DDDD ffffiiiilllleeee
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _m_a_k_e_m_o_v_i_e is used to take image and audio data in a variety of forms and
  21.      put them into a movie file that can be edited with _m_o_v_i_e_m_a_k_e_r or viewed
  22.      with _m_o_v_i_e_p_l_a_y_e_r.
  23.  
  24.      The ----oooo option must be used to specify the file in which the resulting
  25.      movie will be placed.  Image and audio data are taken from the input
  26.      files in the order listed; this ordering determines the order in which
  27.      they will appear when the movie is played.  The options ----cccc, ----llll, ----iiii, ----tttt,
  28.      ----rrrr, ----ssss, ----bbbb, ----qqqq, ----pppp, ----kkkk, and ----aaaa can be used to set the compression scheme,
  29.      loop mode, interlacing, orientation, frame rate, image size, image
  30.      blurring, spatial quality, temporal quality, keyframe rate, and bitrate
  31.      of the output movie (see below).
  32.  
  33.      The input files may be images, audio, QuickTime movies, SGI movies, or
  34.      MPEG-1 movies.  Image file formats are those supported by the IRIS
  35.      ImageVision Library, which include ilSGI, ilFIT, and ilTIFF. Audio file
  36.      formats include AIFF and AIFFC.  _m_a_k_e_m_o_v_i_e can read QuickTime movies that
  37.      have been compressed using "Animation", "Video", "Compact Video", "jpeg",
  38.      or no compression.
  39.  
  40.      For editing operations, it may be preferable to generate the movie in
  41.      uncompressed format, then compress it afterward. This is because most
  42.      compression schemes are slightly lossy, and some image degradation may
  43.      result from long decompression-compression sequences. However, this will
  44.      result in increased disk space requirements, since uncompressed movies
  45.      are much larger than compressed movies. Typically, for "real world" video
  46.      data, the compression achieved is about 8 or 10 to 1, but with simpler
  47.      data, such as many computer graphics images, the compression achieved may
  48.      be much greater, possibly 20 to 1 or so disk space should be planned
  49.      accordingly.
  50.  
  51. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  52.      ----ffff ffffoooorrrrmmmmaaaatttt
  53.           Sets the file format of the output movie.  Choices are "sgi" for the
  54.           SGI movie format and "qt" for the QuickTime movie format.
  55.  
  56.      ----cccc ccccoooommmmpppprrrreeeessssssssiiiioooonnnn
  57.           Sets the compression scheme for the output movie.  Choices for the
  58.           SGI movie format are "none" (no compression), "mvc1" (an SGI video
  59.           compression scheme), "mvc2" (another SGI video compression scheme,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))                                                      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))
  71.  
  72.  
  73.  
  74.           with slower but greater compression and faster decompression than
  75.           mvc1), "jpeg" (standard JPEG compression), "rle" (8-bit run-length
  76.           encoding), and "rle24" (24-bit run-length encoding).  Choices for
  77.           the QuickTime movie format are "qt_anim" (QuickTime Animation),
  78.           "qt_video" (QuickTime Video), "qt_cvid" (Compact Video), "jpeg", and
  79.           "none".
  80.  
  81.      ----DDDD ffffiiiilllleeee
  82.           Describes the contents of a movie file.  Cannot be used with any
  83.           other options.
  84.  
  85.      ----llll llllooooooooppppmmmmooooddddeeee
  86.           Sets default looping mode for playing the movie.  Choices are:
  87.           "once" (play the movie once), "loop" (keep playing it over and
  88.           over), and "swing" (play it front-to-back, back-to-front over and
  89.           over).
  90.  
  91.      ----rrrr ffffrrrraaaammmmeeeerrrraaaatttteeee
  92.           Sets the rate at which the images in the movie will be displayed
  93.           during playback.  This option can only be used when making movies
  94.           from image files.  If any of the input files are movies, they must
  95.           all have the same rate and the output movie will be given that same
  96.           rate.  The default value is 15 frames per second.
  97.  
  98.      ----iiii iiiinnnntttteeeerrrrllllaaaacccciiiinnnngggg
  99.           Sets the interlacing of the image track in the output movie.
  100.           Choices are:  "even" for PAL (even lines first), "odd" for NTSC (odd
  101.           lines first) and "none" (no interlacing).  Images are non-interlaced
  102.           by default.
  103.  
  104.      ----qqqq ssssppppaaaattttiiiiaaaallll____qqqquuuuaaaalllliiiittttyyyy
  105.           Sets the spatial quality of the image track in the output movie.
  106.           This is useful for setting the quality factor of a JPEG compressed
  107.           image track and for setting the spatial quality of QuickTime
  108.           Animation and Video tracks.  _s_p_a_t_i_a_l__q_u_a_l_i_t_y must be a floating
  109.           point number between 0 and 1.0.  The default value of the spatial
  110.           quality varies with the compression scheme.
  111.  
  112.      ----pppp tttteeeemmmmppppoooorrrraaaallll____qqqquuuuaaaalllliiiittttyyyy
  113.           Sets the temporal quality of the image track in the output movie.
  114.           This is useful for setting the temporal quality of QuickTime
  115.           Animation and Video tracks.  _t_e_m_p_o_r_a_l__q_u_a_l_i_t_y must be a floating
  116.           point number between 0 and 1.0.  The default value of the temporal
  117.           compression varies with the compression scheme.
  118.  
  119.      ----aaaa bbbbiiiittttrrrraaaatttteeee
  120.           Sets the bitrate for those compression algorithms that allow you to
  121.           specify a compressed bitrate.  _b_i_t_r_a_t_e is specified in bits/second
  122.           and must be a an integer greater than 0.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))                                                      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))
  137.  
  138.  
  139.  
  140.      ----kkkk kkkkeeeeyyyyffffrrrraaaammmmeeee____rrrraaaatttteeee
  141.           Sets the frequency at which keyframes occur for those compression
  142.           algorithms that use keyframes.  _k_e_y_f_r_a_m_e__r_a_t_e must be an integer
  143.           greater than 0.  The default value of the keyframe rate is 5.
  144.  
  145.      ----tttt   Sets the image orientation of the output movie to be top-to-bottom.
  146.           The default orientation is bottom-to-top.
  147.  
  148.      ----ssss xxxxssssiiiizzzzeeee,,,,yyyyssssiiiizzzzeeee
  149.           Sets the frame size of the movie to be created. This option
  150.           overrides the default frame size, which is the size taken from the
  151.           first image or movie file listed.  If any of the images are the
  152.           wrong size, they will be adjusted to fit by letterboxing.  This
  153.           means that they will made as big as possible within the new size.
  154.           If the aspect ration of the new size is different, there will be
  155.           black borders either at the top and bottom or at the left and right
  156.           of the images.
  157.  
  158.      ----bbbb   Blurs the image track of the output movie with a 1-2-1 vertical
  159.           convolution filter.  This reduces flicker if the movie is played
  160.           back through video.
  161.  
  162.      ----oooo oooouuuuttttffffiiiilllleeee
  163.           This option is required and names the file that will be produced.
  164.  
  165. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  166.      To make a compressed movie, movie1.mv, from audio file afile.AF and image
  167.      file img.fit:
  168.  
  169.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooovvvviiiieeee1111....mmmmvvvv iiiimmmmgggg....ffffiiiitttt aaaaffffiiiilllleeee....AAAAFFFF
  170.  
  171.      To make an uncompressed movie that will play at 10 frames per second from
  172.      audio file afile.AF and image files img1.FIT, img2.FIT, and img3.FIT:
  173.  
  174.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooovvvviiiieeee2222....mmmmvvvv ----cccc nnnnoooonnnneeee ----rrrr 11115555 \\\\
  175.                     iiiimmmmgggg1111....FFFFIIIITTTT iiiimmmmgggg2222....FFFFIIIITTTT iiiimmmmgggg3333....FFFFIIIITTTT aaaaffffiiiilllleeee....AAAAFFFF
  176.  
  177.      To make an odd interlaced, 640x480, JPEG compressed movie with top-to-
  178.      bottom orientation (of the sort that can be played back on the Cosmo
  179.      compression board using NTSC timing) from image files img1.rgb, img2.rgb,
  180.      and img3.rgb:
  181.  
  182.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooovvvviiiieeee3333....mmmmvvvv ----cccc jjjjppppeeeegggg ----ssss 666644440000,,,,444488880000 ----iiii oooodddddddd ----tttt \\\\
  183.                     iiiimmmmgggg1111....rrrrggggbbbb iiiimmmmgggg2222....rrrrggggbbbb iiiimmmmgggg3333....rrrrggggbbbb
  184.  
  185.      To do the same thing for PAL video:
  186.  
  187.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooovvvviiiieeee3333....mmmmvvvv ----cccc jjjjppppeeeegggg ----ssss 777766668888,,,,555577776666 ----iiii eeeevvvveeeennnn ----tttt \\\\
  188.                     iiiimmmmgggg1111....rrrrggggbbbb iiiimmmmgggg2222....rrrrggggbbbb iiiimmmmgggg3333....rrrrggggbbbb
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))                                                      mmmmaaaakkkkeeeemmmmoooovvvviiiieeee((((1111))))
  203.  
  204.  
  205.  
  206.      To make a top-to-bottom QuickTime movie compressed with Compact Video and
  207.      with a spatial quality factor of .5 from image files img1.rgb, img2.rgb,
  208.      and img3.rgb:
  209.  
  210.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooovvvviiiieeee4444....mmmmvvvv ----tttt ----ffff qqqqtttt ----cccc qqqqtttt____ccccvvvviiiidddd ----qqqq ....5555 iiiimmmmgggg1111....rrrrggggbbbb \\\\
  211.                     iiiimmmmgggg2222....rrrrggggbbbb iiiimmmmgggg3333....rrrrggggbbbb
  212.  
  213.      To convert a QuickTime movie (monkey.qt) to an SGI movie (monkey.mv):
  214.  
  215.           mmmmaaaakkkkeeeemmmmoooovvvviiiieeee ----oooo mmmmoooonnnnkkkkeeeeyyyy....mmmmvvvv mmmmoooonnnnkkkkeeeeyyyy....qqqqtttt
  216.  
  217. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  218.      dmconvert(1), dminfo(1), dmplay(1), dmrecord(1),
  219.      soundplayer(1), soundeditor(1),
  220.      imgcopy(1), imginfo(1), imgview(1), imgworks(1),
  221.      mediaconvert(1), movieplayer(1), capture(1), moviemaker(1)
  222.  
  223. AAAAUUUUTTTTHHHHOOOORRRR
  224.      Brian Beach
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.